Skip to content

[RFC] Add MCP server for AI agent integration with Buck2 #1197

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Jump to bottom
Open
hodgesds wants to merge 1 commit into
base: main
Choose a base branch
from
Open

[RFC] Add MCP server for AI agent integration with Buck2 #1197

hodgesds wants to merge 1 commit into from
+2,599 −0

Conversation

@hodgesds
Copy link

@hodgesds hodgesds commented Jan 11, 2026

Implements a Model Context Protocol (MCP) server that allows AI agents to interact with Buck2 through a JSON-RPC interface over stdio. Features:

  • MCP protocol implementation with JSON-RPC 2.0 transport
  • Daemon client for connecting to running Buck2 daemon
  • Tools: buck2_build, buck2_query (cquery/uquery), buck2_targets
  • Async build support with operation polling for long-running builds
  • Operation manager for tracking and cancelling async operations

@meta-cla meta-cla bot added the CLA Signed This label is managed by the Facebook bot. Authors need to sign the CLA before a PR can be reviewed. label Jan 11, 2026
@hodgesds
Copy link
Author

hodgesds commented Jan 11, 2026

Example from Claude code:

❯ claude

╭─── Claude Code v2.1.4 ───────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╮
│                                                     │ Tips for getting started                                                                                                               │
│                Welcome back Daniel!                 │ Run /init to create a CLAUDE.md file with instructions for Claude                                                                      │
│                                                     │                                                                                                                                        │
│                                                     │ ─────────────────────────────────────────────────────────────────                                                                      │
│                       ▐▛███▜▌                       │ Recent activity                                                                                                                        │
│                      ▝▜█████▛▘                      │ No recent activity                                                                                                                     │
│                        ▘▘ ▝▝                        │                                                                                                                                        │
│    Sonnet 4.5 · Claude Max ·                        │                                                                                                                                        │
│    hodgesds Organization                            │                                                                                                                                        │
│                    ~/git/buck2                      │                                                                                                                                        │
╰──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯

❯ /mcp
╭──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╮
│ query (buck2)                                                                                                                                                                                │
│                                                                                                                                                                                              │
│ Tool name: query                                                                                                                                                                             │
│ Full name: mcp__buck2__query                                                                                                                                                                 │
│                                                                                                                                                                                              │
│ Description:                                                                                                                                                                                 │
│ Run cquery or uquery on the Buck2 target graph. cquery operates on the configured target graph (with resolved selects), uquery operates on the unconfigured graph.                           │
│                                                                                                                                                                                              │
│ Parameters:                                                                                                                                                                                  │
│   • output_attributes: array - Attributes to include in output (e.g., ['name', 'deps', 'srcs'])                                                                                              │
│   • query (required): string - The query expression (e.g., 'deps(//foo:bar)', 'rdeps(//..., //foo:bar)')                                                                                     │
│   • query_type: string - Type of query: cquery (configured) or uquery (unconfigured)                                                                                                         │
│   • target_platform: string - Target platform for configuration (cquery only)                                                                                                                │
│   • target_universe: array - Target universe to limit query scope (cquery only)

@meta-codesync
Copy link
Contributor

meta-codesync bot commented Jan 11, 2026

@facebook-github-bot has imported this pull request. If you are a Meta employee, you can view this in D90469508. (Because this pull request was imported automatically, there will not be any future comments.)

@hodgesds hodgesds force-pushed the buck-mcp branch 2 times, most recently from 230f742 to b4cfb44 Compare January 15, 2026 14:50
@hodgesds
Add MCP server for AI agent integration with Buck2
9fea40d 
Implements a Model Context Protocol (MCP) server that allows AI agents
to interact with Buck2 through a JSON-RPC interface over stdio. Features:

- MCP protocol implementation with JSON-RPC 2.0 transport
- Daemon client for connecting to running Buck2 daemon
- Tools: buck2_build, buck2_query (cquery/uquery), buck2_targets
- Async build support with operation polling for long-running builds
- Operation manager for tracking and cancelling async operations

Signed-off-by: Daniel Hodges <hodgesd@meta.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Reviewers

No reviews

Assignees

No one assigned

Labels

CLA Signed This label is managed by the Facebook bot. Authors need to sign the CLA before a PR can be reviewed.

Projects

None yet

Milestone

No milestone

Development

Successfully merging this pull request may close these issues.

1 participant

@hodgesds